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APPLE II SERIAL INTERFACE CARD 
INTRODUCTION 

These are the fundamental abilities of the APPLE Serial Interface usina 
the nearly universal RS232 standard: ’ y 

1. Output from the APPLE II can be sent to a serial printer or other external 
serial device, to the APPLE’S TV screen, or to both. The Serial Interface 
can supply the necessary line-feeds with carriage-returns, etc. 

2. Input for the APPLE II can be taken either from an external device or from 
the APPLE’S keyboard, or from both simultaneously. 

3. The APPLE II can handle half-duplex communications at rates from 75 to 
19,200 baud, in both directions, with a printer, another APPLE, a terminal, 
modem or other RS232 external device. 

4. The Serial Interface can also be connected for current-loop operation with 
a Teletype. 



While this document is intended primarily for APPLE users who are familiar 
with the RS232 interface, many of the terms and concepts will be explained. 
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I INSTALLATION 

HOW TO INSTALL THE SERIAL INTERFACE 

The Serial Interface consists of three parts: the Interface printed-circuit 
card itself, a female DB-25 connector, and a flat ribbon cable between them. 




To install the Serial Interface, you will simply plug the Interface card into a 
socket inside the APPLE II, and then tighten a clamp to hold the DB-25 
connector in place, as follows: 

1. Turn off the power switch on the back of the APPLE II. This is important 
to prevent damage to the computer. 

2. Remove the cover from the APPLE II. This is done by pulling up on the 
cover at the rear edge (the edge farthest from the keyboard) until the two 
corner fasteners pop apart. Do not continue to lift the rear edge, but slide 
the cover backward until it comes free. 

3. Inside the APPLE II, across the rear of the circuit board, there is a row of 
eight long, narrow sockets called "slots.” The leftmost one (looking at the 
computer from the keyboard end) is slot #0, and the rightmost one is slot 
#7. Insert the "fingers” portion of the Serial Interface card into slot #1, the 
second socket from the left. The "fingers" portion will enter the socket 
with some friction and will then seat firmly. The Interface card may be 
placed in any slot except slot #0, the leftmost. However, APPLE’S stan- 
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dard location for printer interfaces is slot #1 (the second from the left). 
This manual and most APPLE software for the Serial Interface are written 
assuming you have installed the Serial Interface card in slot #1. 

4 . Slip the DB-25 connector and its two metal plates as far down as possible 
into one of the three long vertical openings in the back of the APPLE II 
case. One plate goes on the inside of the case; the other plate goes on the 
outside of the case with the connector's flange on the outside of this plate. 
Any of the three large vertical openings may be used, but it is customary 
to use the middle one. Notice that the connector is not symmetrical. When 
seen from the back of the APPLE II, the longer side of the connector 
should be on the left (although it will work in either position). 

5 . Tighten the screws on the DB-25 connector just until the connector as- 
sembly can no longer be moved in the opening. Excessive tightening will 
cause the metal plates to bend. 

6. Replace the cover of the APPLE II, remembering to start by sliding the 
front edge of the cover into position. Press down on the two rear corners 
until they pop into place. 

7 . The Serial Interface is installed, and the APPLE II may now be turned on. 



COMPATIBILITY WITH EXTERNAL DEVICES 

For communications between computers and computer-related equip- 
ment, the most widespread and universal standard is the RS232 standard. 
The RS232 standard specifies the electrical parameters, the form of the 
signals, and even the type of connector to be used in an interface. The 
APPLE Serial Interface complies with this standard. 

The RS232 standard allows for a number of different communication 
speeds. These speeds are measured in terms of a unit called the "baud." 
Each multiple of 10 baud is equal to about 1 character sent or received per 
second; 300 baud is roughly equal to 30 characters per second. The Serial 
Interface can operate at any of 256 different speeds, from 75 baud to 19,200 
baud. 

Computers and their related devices do not actually send the keyboard 
characters themselves, of course. Each character is encoded in the form of 
electrical signals, and it is these electrical signals which are sent and re- 
ceived. 

The APPLE Serial Interface can communicate with any device that 
specifies RS232 operation between 75 and 19,200 baud. Many devices can 
operate at a number of speeds. Very often a set of switches or a rotary dial 
selects the baud rate. These external devices should be set to a particular 
baud rate before being connected to the APPLE. The highest baud rate 
available is usually preferred. The Serial Interface should be set for the same 
baud rate, using the first 3 levers of the Serial Interface's DIP switch (this is 
explained in the section, SERIAL INTERFACE OPERATING PARAME- 
TERS). All common baud rates are listed in the section, SERIAL INTER- 
FACE TIMING. 

While such operation does not conform to the RS232 standard, the APPLE 
Serial Interface can also be operated in the current-loop mode necessary to 
communicate with a serial teleprinter such as the Teletype Model 33ASR. 



RS232 CONNECTOR USAGE 

The standard DB-25 connector, which is supplied with the Serial Interface, 
has 25 pins. Six of these are connected internally to the APPLE Serial Inter- 
face, but for most applications only three of them need be used. If you don't 
have a ready-made cable that can go from the Interface's DB-25 connector to 
the external device, then you will have to wire an interconnecting cable. A 
cable is just a number of electrically distinct wires that physically run 
alongside each other. When you wire the cable, you will have to refer to the 
DB-25 connector's pin numbers. These numbers are molded into the connec- 
tor, although sometimes they are almost vanishingly small. 
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The following list describes the functions of the active pins on the Serial 
Interface connector. The other pins may be left unconnected. 



PINS 4 & 5 These pins have been wired together (jumpered) at the Serial 
Interface card. No connection need be made to these pins. 

PINS 6, 8 & 20 These pins have been wired together (jumpered) at the 
Serial Interface card. No connection need be made to 
these pins. 

PIN 7 This is called “signal ground.” It should be wired to pin 7 at the other 
end of the cable. If there is no connector at the other end of the cable, 
then the Serial Interface’s pin 7 should be wired to a signal ground 
connection on the external device. (If this is insufficient information, 
any additional data would have to be supplied by the manufacturer or 
designer of the external device.) 

PIN 2 The characters from the external device arrive at the computer via this 
pin. 



PIN 3 The characters leaving the computer, on their way to the external 
device, exit via this pin. 



Pins 2 and 3 have been left for last since, if the external device end of the 
cable is another 25 pin connector, there are two ways that they might be 
wired. No damage is caused by wiring these pins the wrong way, but charac- 
ters will not be sent out or received. 



A. If the external device is a terminal or printer with an RS232 interface 
itself, then pin 2 on the APPLE'S end of the cable should be wired to pin 2 at 
the external device’s end of the cable. Similarly, pin 3 on the APPLE’S end of 
the cable should be wired to pin 3 at the external device’s end of the cable. 
Most of these devices, like the APPLE Serial Interface, also have a female 
DB-25 connector. Therefore your cable will (most likely) need to have a male 
DB-25 connector at each end. 



B. If the external device is a modem, or another computer with a standard 
serial interface, then its interface will send characters out via pin 3 and 
receive characters via pin 2 just as the APPLE Serial Interface does There- 
fore, you must wire pin 2 at the APPLE’S end of the cable to pin 3 at the 
modem end of the cable; and wire pin 3 at the APPLE’S end of the cable to 
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pin 2 at the modem end of the cable. Modems usually have a male DB-25 
connector. Therefore, you will probably need a cable with a female DB-25 
connector at the modem end, and a male DB-25 connector at the APPLE 
end. 




i 

Note that only the wires to pins 2 and 3 are involved. No other wires need be changed no 
matter what external RS232 device is connected to the APPLE Serial Interlace. 

i 



Most commercially prepared cables are simply extension cables: they 
connect identically numbered pins at the two ends of the cable. For use with 
a modem, you may have to re-wire the cable, interchanging the wires to pins 
2 and 3 at one end. If you would rather not tamper with a ready-made cable, 
you can make an adapter with a male DB-25 connector at one end and a 
female DB-25 connector at the other end. It should be wired with pins 7 
connected, and pins 2 and 3 cross-connected. This adapter, when connected 
between the APPLE’S Serial Interface and a standard RS232 cable, allows 
the Interface to “talk” to most modems. 
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CURRENT-LOOP OPERATION WITH A TELETYPE 

If you wish to use the APPLE Serial Interface to communicate with a current- 

loop teleprinter such as the Teletype Model 33ASR, you will be interested in 

three other Interface pins. 

PIN 13 In current-loop operation, the characters from the Teletype arrive at 
the APPLE via this pin. This pin should be wired to terminal 3 on the 
Teletype Model 33’s barrier strip. 

PIN 12 The return path of the input current loop (the loop for characters 
arriving from the Teletype) should be connected to this pin. (In fact, 
the Serial Interface does not care which way current flows through 
this input loop. We have arbitrarily chosen pin 13 as the input and pin 
12 as the return, but the roles of these two pins can be inter- 
changed.) We suggest using signal ground (at pin 7) for the return 
path, in which case you should connect pin 12 to pin 7. 

PIN 23 In current-loop operation, the characters leaving the APPLE, on their 
way to the Teletype, exit via this pin. Wire this pin to terminal 7 on the 
Teletype Model 33's barrier strip. The return path for this output 
current loop is also the signal ground at pin 7. For half-duplex opera- 
tion, connect terminals 4 and 6 on the Teletype Model 33’s barrier 
strip. 
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Caution! Pins 1 and 2 on the Model 33 barrier strip are connected to 120f 
Volts AC. 



II OPERATION 

USING THE APPLE SERIAL INTERFACE 

The Serial Interface allows the APPLE II to communicate with other elec- 
tronic devices which are external to the computer. These devices may be 
—to give a few examples— terminals, printers, or other computers. The Se- 
rial Interface can be controlled through BASIC programs or through 
assembly-language programs. It can also be controlled directly, by typing a 
few characters on the APPLE'S keyboard. 

In the following discussion, it will be assumed that you are familiar with the 
APPLE II BASIC Programming Manual, and that your APPLE II is operating 
in BASIC, with the Serial Interface installed in slot #1. 

Here is a list of the most common tasks the Serial Interface is called upon 
to do, and the commands that accomplish them. 

1. Send subsequent output to the Serial Interface. 

PR#1 

2. Cancel the effect of PR#1, sending output only to APPLE’S TV screen. 

PR#tf 

3. Accept subsequent input from the Serial Interface, as well as from the 
APPLE’S keyboard. 

IN#1 

4. Force the APPLE to convert all lower-case characters to upper-case, as 
they arrive from the external device. 





( — ' 
Lul 


(type the 




key, then type O 



5. Allow the APPLE to accept lower-case characters that arrive from the 
external device. If displayed on APPLE’S TV screen, the lower-case 
characters will appear as upper-case characters in inverse video. 




These tasks are more fully explained, and some fine points considered, in 
the next few pages. 

To understand exactly how the Serial Interface operates, it is useful to think 
of the APPLE II as divided into three parts: 

1. The APPLE’S keyboard, which generates characters (when you type on 
it). 

2. The APPLE'S TV screen, which can absorb characters (and make them 
visible). 

3. The APPLE’S processor, or "brain,” which can control the flow of charac- 
ters, and act upon them. 
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You can also think of any external device as being able to generate 
characters or absorb characters, or both. The external device may or may 
not have a “brain," but this is not important in understanding the operation of 
the Serial Interface. 



EXTERNAL DEVICE 

CONSISTING OF: 



EXTERNAL 




EXTERNAL 


CHARACTER 


and/or 


CHARACTER 


GENERATOR 


ABSORBER 



l l 




APPLE II 



FIGURE 1 



Figure 1 shows the three parts of the APPLE II, and the only parts of any external device that 
ailed the Serial Interface. It also shows the normal interconnection between these parts. 
When the APPLE II is lirst turned on, it will ignore the external world, listening only to its own 
keyboard and displaying characters only on its own TV screen. 



PRELIMINARY DISCUSSION OF THE IN# AND PR# 
COMMANDS 



There are eight sockets, called “slots," on the back of the main circuit 
board inside the APPLE II. The leftmost one (as viewed from the keyboard 
end of the computer) is slot #0, and the rightmost one is slot #7. (See the 
section, HOW TO INSTALL THE SERIAL INTERFACE.) APPLE BASIC has 
two commands for selecting among these slots for input and output. In effect, 
when you first invoke BASIC, the commands 
IN#0 
and 
PR#0 

are automatically executed. The first of these commands, IN#0, tells the 
APPLE to 

Take INput from the APPLE keyboard. 

And the second command, PR#0, instructs the APPLE to 

i n 



Send PRinting to the APPLE’S TV screen. 

This is the “normal,” or APPLE-alone condition shown in Figure 1. Now, 
however, if the command (or program statement) 

IN#1 

is executed, the APPLE will henceforth take its input from whatever is plug- 
ged into slot #1. Similarly, if the command 

PR#1 

is executed, all output will be sent to whatever is plugged into slot #1 . If there 
is nothing plugged into the specified slot, then the system may hang, or your 
program may be erased, or other strange behavior may result. Notice that 
slot #0 is special, and refers to the APPLE itself. 



SENDING YOUR OUTPUT TO AN EXTERNAL DEVICE AND 
RECEIVING INPUT FROM AN EXTERNAL DEVICE 



In the following examples, the commands 

PR#1 

and 

IN#1 

will be typed on the APPLE’S keyboard. If you have put your Serial Interface 
into slot #1 (the second one from the left, as described in the section, HOW 
TO INSTALL THE SERIAL INTERFACE) the commands will work exactly as 
shown. If you use some other slot, you will have to substitute the number of 
that slot. Slot #0 may not be used for the Serial Interface. 

Attach an appropriate cable (see the section, RS232 CONNECTOR US- 
AGE) from the DB-25 connector of the Serial Interface to the external device 
with which you wish to communicate. Reset your APPLE II by pressing the 

Midi EI3 

RESET key, and invoke BASIC typing a □ ( Q means depres- 

sing the □ key while simultaneously holding down the key marked 
). If you are not familiar with this procedure, see your APPLE II 
BASIC Programming Manual. When the prompt character appears, type the 
command 

PR#1 

( and press the key, of course) . From now on, any characters you 

type will be sent out through the Serial Interface to the external device. The 
characters will appear on the APPLE’S TV screen only if levers 5 and 6 of the 
Serial Interface’s DIP switch (located directly on the Interface card itself, near 
its upper edge) are ON when PR#1 is typed. (This is more fully explained in 
the section, SERIAL INTERFACE OPERATING PARAMETERS.) Characters 
coming in from the external device will be ignored. The operation of the 
system after you type PR#1 is shown in Figure 2. 
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EXTERNAL DEVICE 

CONSISTING OF:‘ 




APPLE II 



FIGURE 2 



Operation of the system after executing PR# 1 



The APPLE'S "brain" is still connected, and the command 

PR#0 

will restore normal (Figure 1) operation, in which the APPLE’S output charac- 
ters are not sent through the Serial Interface. Normal operation can also be 

EE9 

restored by pressing the E231 key and then typing a Q , but this 
option is not available if the Interface is being controlled by a program. 

To let the external source of characters control the APPLE II, use the 
command 

IN#1 

After this command, the APPLE will accept input from the external device 
connected to the Serial Interface, as well as from its own keyboard. Figure 3 
shows this condition. If there is no external device connected to the Serial 

Interface, the system will “hang" after this command. Use Q to 

recover. 



EXTERNAL DEVICE 

CONSISTING OF: 




APPLE II 



FIGURE 3 



Operation of the system after executing IN #1 

Normal operation is restored if the command 

IN#0 

is typed on the APPLE’S keyboard. Normal operation is also restored if the 
external device sends the command 

IN#0 

Pressing the l^Ti key and typing a 0 on the APPLE’S keyboard 
will also restore normal operation; but this cannot be done from a program, 
and will not be mentioned again. 

Typing both commands, 

PR#1 

and 

IN#1 

will give the external device full control of the APPLE II. In this remote 
mode” (shown in Figure 4), a friend could use your APPLE from across the 
country— or across the room. 
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EXTERNAL DEVICE 

CONSISTING OF: 
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FIGURE 4 



Remote Mode: operation ot the system after executing PR# 1 and IN# 1 . 



Ill DEFAULT PARAMETERS AND THE DIP SWITCH 



INITIALIZING THE SERIAL INTERFACE 



Before the Serial Interface can be used, it must be initialized. Initializing 
the Interface sets all of the Interface operating parameters to their default 
values. Assuming slot #1, the Interface is initialized each time either of the 
following BASIC commands is typed: 



PR#1 



or 



IN# 1 




and each time any of the following Monitor commands are typed: 




When used within a program, a command (such as PR#1) that transfers 
APPLE'S output to the Serial Interface does not initialize the Interface until 
the first character is actually sent out (with a PRINT statement, for instance). 
Similarly, if during a program a command (such as IN# 1 ) tells the APPLE to 
get its input from the Serial Interface, the Interface is not initialized until the 
APPLE actually looks for its first input character (in an INPUT statement, for 
instance). 



SERIAL INTERFACE OPERATING PARAMETERS 



The Serial Interface has ten user-definable operating parameters. Each 
time the Serial Interface is initialized, the ten operating parameters are given 
their default values. Five of the default values are determined by the 7 levers 
of the Serial Interface’s DIP switch (located on the Interface’s printed-circuit 
card, near the upper edge). The DIP switch levers set the default .values for 
these five operating parameters: Baud Rate (levers 1, 2 and 3), Carriage 
Return Delay (lever 4), Line Width plus APPLE Video(levers 5 and 6), and 
Line Feed (lever 7). Changing the settings of the DIP switch levers after 
initialization has no effect until the next initialization. 
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SETTING THE DIP SWITCH DEFAULTS 

1) Baud Rate 

DIP 

Switch Levers 

1 2 3 

On On On 
Off On On 
On Off On 
Off Off On 
On On Off 
Off On Off 
On Off Off 
Off Off Off 

On initialization, the settings of DIP switch levers 1 , 2 and 3 determine the 
rate at which bits may be transmitted to the external device. 30(7 baud is 300 
bits per second. Under default conditions, each character is transmitted 
using 1 1 bits (1 start bit, 8 data bits, and 2 stop bits). 

2) Carriage Return Delay 

DIP Default 

Switch Car. Return 
Lever Delay 

4 

On Disabled 

Off Enabled 

If DIP switch lever 4 is Off (Delay Enabled), the Serial Interface will wait 
briefly (approximately V* second) after transmitting a carriage return, to allow 
the printer to complete this movement. If you are transmitting to an external 
TV screen, this delay is probably unnecessary, and lever 4 may be turned On 
(Delay Disabled). 





I) Line Width plus APPLE Video 

DIP Default Default 

switch Line APPLE 

.evers Width Video 

5 6 

n On = 40 Char/Line Enabled 

ff On = 72 Char/Line Disabled 

n Off = 80 Char/Line Disabled 

ff Off = 132 Char/Line Disabled 




I 
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After a carriage return, the settings of DIP switch levers 5 and 6 determine 
the maximum number of characters transmitted before the Serial Interface 
will force another carriage return to be sent out. Characters will be displayed 
on the APPLE'S TV screen only if the default line width is set to 40 characters 
per line (levers 5 and 6 On). After initialization, the line width can be changed 
from 40 characters per line, but the display on the APPLE’S TV screen will not 
correspond to the display on the external device, as transmitted carriage 
returns are not accompanied on the APPLE'S TV screen by line feeds. 

4) Line Feed 

DIP Default 

Switch Line 

Lever Feed 

7 

On = Disabled 

Off = Enabled 

If DIP switch lever seven is Off (Line Feed Enabled), the Serial Interface 
will transmit a line feed after each carriage return it transmits. If the external 
device automatically supplies its own line feed after each carriage return 
received, you can set lever seven to On (Line Feed Disabled) to avoid 
double-spacing. 



PERMANENT DEFAULTS 

During each initialization, the five remaining operating parameters are set 
to their permanent default values: 

1. Parity defaults to its disabled condition (no parity bit). 

2. Checksum defaults to its disabled condition (no checksum character). 

3. Lower-Case defaults to its disabled condition (converts all incoming 
lower-case characters to upper-case). 

4. Number of Data Bits defaults to 9 (8 data bits plus one start bit). 

5. Number of Stop Bits defaults to 2. 

These parameters will be explained in the following section; they can only 
be changed by software commands after initialization. 
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IV ACCESS TO OPERATION PARAMETERS 



DESCRIPTION OF SERIAL INTERFACE OPERATION 

For most applications, the default operating parameters (both those that 
are fixed and those that can be set with the DIP switch) will be just what you 
need: your parameters will be set each time the Interface is initialized. In that 
case, the following section will be interesting but not necessary. However, the 
Serial Interface is designed to be very flexible, so that its operating paramet- 
ers can be easily modified for use in a wide variety of special applications. 
This section gives a rather detailed description of the Serial Interface's opera- 
tion. The following section shows you how to make any of the many possible 
modifications to that operation, should they be necessary. 

Each character that is sent out through the Serial Interface is transmitted 
as a series of bits, in the following sequence: 

1. One “Start Bit," a “low” voltage which tells the external device that a 
character is going to be transmitted. 

2 . From two to eight “Data Bits” (default is eight bits; can be changed by the 
user), a sequence of “high” and “low" voltages that represent the actual 
character code being transmitted. The default is eight bits because the 
APPLE normally handles data in eight-bit groups. If your external device 
sends and receives data in groups of fewer than eight bits, you must set 
the Serial Interface to send and receive these smaller groups. 

3 . If enabled, one “Parity Bit" (default is no parity bit; even or odd parity can 
be enabled by the user). This is a transmission-accuracy checking bit 
which the external device looks at for errors and then discards. 

The parity bit is found as follows: all the 1-bits in the actual character 
code are added together, and the result's evenness or oddness is com- 
pared with the type of parity-checking selected. For instance, the binary 
ASCII code for the letter S is 101001 1 ; the sum of the 1-bits is 4, an even 
number. If Even parity has been enabled, the comparison is true , and a 
0-bit is sent at the end of the character. If Odd parity has been enabled, 
the comparison is false, and a 1-bit is sent. If parity has not been enabled, 
no extra bit is sent. Check your device’s operation manual to see if it 
sends and receives parity bits. 

4 . From one to 127 "Stop Bits” (default is two bits; can be changed by the 
user), a "high” voltage which tells the external device that a character has 
been completely transmitted. Each external device requires a particular 
number of stop bits after every character; see the device's operation 
manual. 

This same sequence will be used by the external device when it transmits 
to the APPLE. Timing is very important to correct transmission and reception. 
The Serial Interface sends out and receives bits at fixed intervals of time set 
by the "Baud Rate" (default is set by DIP switch levers 1, 2 and 3; can be 



19 




f 



( 

changed by the user). The Serial Interface and the external device must be 
set to the same baud rate and parity option, in order to interpret the sequence 
of high and "low" voltages correctly. The same is true when the external 
device is transmitting characters to the APPLE Serial Interface. 

When the Serial Interface has sent out the number of characters set by the 
Line Width (default is set by DIP levers 5 and 6; can be changed by the 
user), it transmits a Carriage Return” to the external device. After sending a 
carriage return, it may wait during a fixed V-i-second "Carriage Return Delay” 
(if enabled, default set by DIP lever 4; can be changed by the user) before 
sending the next character, to allow the printer to complete this movement. 
Then the Interface may send a "Line Feed” (if enabled: default set by DIP 
lever 7; can be changed by the user), so that subsequent characters will 
appear on the following line. 

Finally, each time it completes sending 256 characters in a "Batch Move," 
the Serial Interface may send a "Checksum” character (default is no 
checksum character; can be changed by the user). This is a transmission- 
accuracy checking character which the external device looks at for errors and 
then discards. The checksum character is found by XORing the previous 256 
characters, as follows: the second character is XORed with the first, the third 
with that result, the fourth with that result, and so on. Check your device's 
operation manual to see if it sends and receives checksum characters. Dur- 
ing Batch Moves, the Serial Interface and the external device must be set to 
the same checksum option. 



LOWER-CASE CHARACTERS 



While the APPLE generates and displays characters only in upper case 
capital letters), your external device may generate both upper-case and 
ower-case characters. When lower-case characters are received by the 
\PPLE through the Serial Interface, they can be treated in two different 
vays: 

■ Convert all incoming lower-case characters to upper-case characters (in- 
coming upper-case characters are not affected). Since this is the usual 
APPLE mode, any incoming characters displayed on the APPLE’S TV 
screen will look fine. This is the permanent default condition; but it can be 
changecTby the user, after initialization. 

Accept all incoming lower-case characters as lower-case (again, incom- 
ing upper-case characters are not affected). APPLE'S TV screen display 
of characters is designed for upper-case only, so any display of incoming 
lower-case characters will look strange. If the characters are being dis- 
played as they arrive from the external device, APPLE will show the 
lower-case characters as upper-case characters in inverse video (black 
letters on a white background). Once stored in APPLE'S memory, lower- 
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case characters will be displayed (when LISTed, for instance) as a 
strange assortment of upper-case characters in normal (white on black) 
video. There is one exception to this: if the stored lower-case characters 
are being displayed as they are sent out through the Serial Interface, they 
will again appear as upper-case characters in inverse video. Note that 
these peculiar displays do not reflect the lower-case characters them- 
selves: in this mode they are stored correctly in APPLE'S memory, and 
may be printed correctly on any appropriate external device. Note also 
that this mode does not add any capability to generate lower-case charac- 
ters from the APPLE keyboard. 



CHANGING SERIAL INTERFACE PARAMETERS THROUGH 
SOFTWARE COMMANDS 

Ten of the Serial Interface parameters can be changed from their initialized 
(default) values, through the use of commands in machine language or 
BASIC. Once an Interface parameter is set by a software command, that 
parameter remains unchanged until the Serial Interface is reinitialized or the 
parameter is reset by another software command. For more discussion of the 
various parameters functions, see the previous section. 

In the following descriptions, the letter "s" refers to the number of the 
printed-circuit board slot inside the APPLE, in which the Serial Interface card 
is installed (see the section, HOW TO INSTALL THE SERIAL INTERFACE). 

1. BAUD RATE (assembly-listing variable: BRATE) 

Memory location 1144+s ($478+s, in Hexadecimal) contains APPLE'S 
baud "quantum” number, which specifies how many "quanta” the APPLE 
is to wait between sending out bits through the Serial Interface. One 
quantum equals 53 APPLE II cycles (51.94 microseconds) per transmit- 
ted bit. The default value is set with levers 1, 2 and 3 of the Interface 
card's DIP switch (see the section, SETTING THE DIP SWITCH DE- 
FAULTS). From BASIC, to change the baud rate from the default value to 
B use the command 
I POKE 1144+s, r 

where r is the integer, from fo through 255, that is closest to 
1 /(.0O005 1 94 * B) 

) For further information, see the section SERIAL CARD TIMING. 

2. STOP BITS (assembly-listing variable: STBITS) 

Memory location 1272+s ($4F8+s, in hexadecimal) contains the 
Number of Stop Bits (Note: the one parity bit is included in this number, if 
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parity is enabled). The default value is 2 stop bits (and no parity bit). To 
change the number of Stop Bits from BASIC, use the command 
POKE 1272+s, r 

where r is an integer, froml through 127. To determine the correct number 
of stop bits for your external device, see the external device’s operation 
manual. 



Note: you must add the one parity bit to the Number of Stop Bits, if 
parity is enabled. 



3. PARITY/CHECKSUM OPTIONS (assembly-listing variable: STATUS) 

Memory location 1400 + s ($578 + s, in hexadecimal) contains a 
number, the lower three bits of which determine two parity options 
(enable/disable and even/odd) and one checksum option (enable/ 
disable). If the remote device with which your Serial Interface is com- 
municating requires a parity bit to be sent or received with each character, 
you can tell your Serial Interface to do this task. You can also specify 
which type of parity check (even parity or odd parity) is to be sent and 
received. If your remote device requires that a checksum be sent after 
every 256 characters in a Batch move, you can tell the Serial Interface to 
send one. To decide whether your external device requires either a parity 
bit or a checksum character (or both), consult the device's operation 
manual. The three Parity/Checksum options are changeable from BASIC 
by using the command 
POKE 1400+s, r 

where r is an integer from 0 through 7. The actual value that r should be 
assigned is determined as follows: 

Bit 0: 1 = odd parity (This is the least significant, 

0 = even parity or rightmost, bit.) 

Bit 1 : 1 = no parity (initial default value) 

0 = parity enabled 

Bit 2: 1 = no checksum (initial default value) 

0 = checksum enable 

First determine whether or not a parity bit need be sent (Bit 1). If yes, 
then decide whether the parity should be odd or even (Bit 0). Also, deter- 
mine whether or not a checksum character need be sent during Batch 
moves (Bit 2). For example, let’s assume that an even parity bit must be 
sent, with no checksum. Bit 0 gets a value of 0, Bit 1 gets a value of 0, and i 

Bit 2 gets a value 1. This binary number 100 is converted to its decimal 
equivalent of 4 and POKE’ed (assuming slot #1): 

POKE 1401, 4 



1. INPUT/OUTPUT BUFFER (assembly-listing variable: BYTE) 
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Memory location 1656+s ($678 +s, in hexadecimal) is the input buffer 
for the individual character that has just been received through the Serial 
Interface from the external device. Assuming the Interface is in slot #1, 
the BASIC command 

PRINT PEEK (1657) 

will print on the APPLE’S TV screen the ASCII value of the character just 
received. 

5. LINE WIDTH (assembly-listing variable: PWDTH) 

Memory location 1784+s ($6F8+s, in hexadecimal) contains the 
“Printer Width,” or number of characters per line. After transmitting this 
number of characters, the Serial Interface will then transmit its Carriage- 
Return sequence. To change the number of characters per line, from 
BASIC, use the command 
POKE 1784+s, r 

where r is an integer, from 0 through 255, specifying the number of 
characters per output line. To determine the maximum line width for your 
external device, consult the device’s operation manual. 

Note: if r is set to zero, the Serial Interface will not force any carriage 
returns to be transmitted. The output characters will be transmitted in a 
continuous stream. 

6. DATA BITS (assembly-listing variable: NBITS) 

Memory location 1912 + s ($778+s, in hexadecimal) contains the 
number of Data Bits, plus one for the start bit. In the APPLE, data is 
handled in groups containing eight bits. If you are communicating with an 
external device which also handles data in eight-bit groups, the default 
Number of Data Bits is perfect (8 data bits plus 1 start bit). However, if 
your external device handles data in groups of fewer than eight bits, you 
must set the Serial Interface to send and receive these smaller data 
groups. 

When receiving data groups of fewer than eight bits, the Serial Inter- 
face will supply 1’s to fill the remaining high-order bits of each eight-bit 
group in APPLE’S memory. Similarly, when the Serial Interface Is transmit- 
ting data groups of fewer than eight bits, the unused high-order bits in 
each of the APPLE’S eight-bit data groups must be set to 1’s. 

To change the Number of Data Bits from BASIC, use 

POKE 1912+s, r 

where r is an integer, from 3 (2 data bits plus one start bit) through 9 
(8 data bits plus one start bit). 
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Note: to calculate r, you must add one start bit to the number of data 
bits. If r is set to less than the default value of 9 (8 data bits plus one start 
bit), you must set the unused high-order data bits to ones before transmit- 
ting the data. Received data will also have unused high-order data bits set 
to ones. 



Example: Binary Coded Decimal is a code for sending numbers in 
four-bit data groups. The BCD code for the number 7 is 0111. If the 
Number of Data Bits, r, is set to 5 (4 data bits plus 1 start bit), BCD for the 
number 7 must be stored in the APPLE’S eight-bit byte as 11110111 
before the data group 01 1 1 can be transmitted. Similarly, if the data group 
01H IS received by the Serial Interface, it will be stored in the APPLE'S 
eight-bit byte as 11110111, 

7. OPERATION MODES (assembly-listing variable: FLAGS) 

Memory location 2040+s ($7F8 + s, in hexadecimal) contains a 
number, four of whose bits determine four separate modes of operation. 
To alter the operation modes from BASIC, use the command 

POKE 2040+s, r 

where the value of r is determined by use of the following table: 



r's 

Binary 

Bit 

3it#0 



(Decimal 
Equiv., Operation Set 

If Bit=1) By Bit Value 

(1) 1 = Line feed after carriage 

return 

0 = No line feed 

(32) 1 = Lower-case input enable 

0 = Convert lower-case to 
Upper-case 

(64) 1 = No delay after carriage 

return 

0 = Carriage return de lay enable 

(128) 1 = No display on APPLE'S TV 

0 = APPLE'S display enabled 



Default 

(Set by 
Lever 7) 



(Permanent Default) 

(Set by 
Lever 7) 

(Set by 
Levers 5&6)* 



*APPLE’s TV display is only enabled during initialization if DIP switch 
levers 5 and 6 are both On. 

For example, let us assume that you wish to have line feeds, upper- 
case only, carriage return delay, and no APPLE display. This would re- 
quire that bits 0 and 7 have a value of 1 , and bits 5 and 6 have a value of 
0. Add up the decimal equivalents of all of the bits that were assigned the 
value 1 (the decimal equivalents are the numbers in parentheses, next to 
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the Bit #’s). The decimal equivalents for bits 0 and 7 are 1 and 128 
respectively; therefore the total of the decimal equivalents is 129. This 
value is assigned to r, and POKE'ed (assuming slot #1)- 

POKE 2041, 129 



If you wish to change only Bit #5 (lower-case input enable/convert), you 
can do so with the following commands: 

[jij (Press and release the key, and then type j^| ) 

This changes r’s Bit #5 to a zero, the default value. After this command, 
all lower-case characters arriving through the Serial Interface from an 
external device will be converted to upper-case characters. Incoming 
upper-case characters are not affected. This is the APPLE'S usual mode, 
so any APPLE display will look fine. 




This changes r's Bit#5 to a one. After this command, lower-case 
characters arriving through the Serial Interface from an external device 
will be stored as lower-case characters in APPLE'S memory. Upper-case 
characters are not affected. Since the APPLE was designed for upper- 
case characters only (BASIC will accept lower-case characters only in 
quoted strings), any APPLE display of these lower-case characters will 
look strange on the TV screen. See the previous section for details. How- 
ever, the characters are stored correctly, and may be printed correctly on 
any appropriate external device. 

Note: the commands I in 0 and nn Q are Serial Interface input 
commands. They will have no effect unless the Interface has been initial- 
ized for input (by IN# 1 , for instance). 



8. TAB 

The TAB and comma functions in Integer BASIC (HTAB in 
APPLESOFT) will sometimes work in conjunction with the Serial Inter- 
face, but have several restrictions (fewest for comma-tabbing). A TAB of 
less than 18, if it would end directly on a character already printed, may be 
simply tabbed from that character’s position. No TAB can cause printing to 
occur to the left of the last printed character on the current line. An attempt 
to do so usually causes printing to occur in the first available position to 
the right of the last printed character. Both Integer BASIC’s TAB and 
APPLESOFT’S HTAB send out a carriage return for every 40 positions in 
the tab instruction, and then tab the remaining positions. For tabbing to 
any position (including those beyond position 40), you can use the BASIC 
command 
POKE 36, r 

where r is an integer, from 0 through 255, equal to the number of print 

95 




f r 

V DIRECT USE OF THE INTERFACE 



TRANSMITTING A CHARACTER WITHOUT USING PR#1 

Occasionally, it is useful to send a character out through the Interface 
without using a PR# command to change the “output vector" (the system 
pointer that tells your APPLE where to send its output, normally to its TV 
screen). To use the Serial Interface directly, follow these two steps: 

1 . Into APPLE'S accumulator, put the ASCII code of the character to be sent. 

2. CALL -16384 4- (256 * s) 

where s is the Interface's slot number (the equivalent hexadecimal location to 
CALL is $Cs00). There are various ways to get a number into the APPLE'S 
accumulator, but one way is to write a very small machine-language sub- 
routine to do it, a nd the n CALL that subroutine from your BASIC program. To 
begin, press the G2a3 key to enter the Monitor (prompt character: * ), and 
then (assuming slot #1) type 

300: A9 11 4C 00 Cl E3H 

Check your work by typing 

300L 

Ignoring most of the resulting display, the first two lines should look like 
this: 

0300- A9 11 LDA #$11 

0302- 4C00C1 JMP $C100 

The first instruction (at hexadecimal location $300) tells the APPLE to 
LoaD the Accumulator with the number in the next location (hexadecimal 
location $301 ). For now, that number is $1 1 . The second instruction is equiva- 
lent to CALL —16128 in BASIC: it tells the APPLE to JuMP to hexadecimal 
location $C100, which starts the Serial Interface character output routine. To 
use this subroutine in your BASIC program, you must first put into hexadeci- 
mal location $301 (that's location 769, in decimal) the ASCII code for the 
character you want the Serial Interface to send out. Then you will CALL the 
subroutine at hexadecimal location $300 (768, in decimal). Here is a short 
program that uses the above machine-language routine to send out one 
character at a time: 

10 INPUT "LETTER?”, L$ 

20 POKE 769, ASC(L$) 

30 CALL 768 
40 GOTO 10 

BATCH MOVES 

At times it is useful to send or receive large amounts of information very 
quickly. This can be accomplished through use of a Batch Move. The Batch 
subroutines are "utility" routines. They are intended to be used for special 



positions to be tabbed. This command suffers most of TAB'S restrictions, 
except for the 40-position limit. In APPLESOFT, the TAB function (used 
inside a PRINT statement) can also cause tabbing of more than 40 posi- 
tions. 
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applications such as Data Collection, Mass Storage and Retrieval Systems 
and sending program sequences to control external devices. To understand 
how to use the Batch routines on the simplest level, refer to the examples 
below. For an example of using the Batch Moves from BASIC, see the next 
section, BATCH MOVES FROM BASIC. 



Note, before using the Batch routines, you must have initialized the Serial 
Interface (by typing PR#1, for instance) and you must have set the desired 
P ar ' an ^ checksum parameters. The Batch Move commands deal directly 
S h ?oo r ‘ al lnterface ( not through the input and output “vectors” set by 
iN^and PR#); therefore these commands are the same, regardless of which 
slot contains the Interface card. 



1. Batch Output 



When in the Monitor (prompt character: * ), type 

3F8: 4C 41 C9 

This prepares the APPLE to jump to hexadecimal location $C941 in the 

rm 

Serial Interface's Read-Only Memory when a 0 is typed on the 
eyboard. This jump causes the Batch Output routine to execute. When 
you are ready to actually send the data, type 

E5Z39 

addrl . addr2 Q m 

^ her ® „" addrl " is the hexadecimal starting address of the data, and 
addr2 is the hexadecimal ending address of the data. For example, if we 
wanted to send the information that is stored in memory from address 
$2000 through address $3FFF, we would type 

KTfll 

2000.3FFF Q r^THl 

As soon as the return is typed, the data from address 2000 to address 
3FFF will be sent through the Serial Interface from the APPLE to the 
external receiving device. 



2. Batch Input 



When in the Monitor, type 



3F8: 4C 3D C9 



RETURN 




This prepares the APPLE to jump to hexadecimal location $C93D in the 
Serial Interface's Read-Only Memory when a control Y is typed on the 
keyboard. This jump causes the Batch Input routine to execute. When you 
are ready to actually receive the data, type 

toTira 

addrl . addr2 Q ffTTHl 



where "addrl” is the hexadecimal starting address in which the incoming 
data will be stored, and “addr2” is the hexadecimal ending address in 
which the incoming data will be stored. For example, if we wanted to 
receive data from an external device, and store it in our APPLE’S memory 
from address $4000 through address $5FFF, we would type 



4000.5FFF 



EE3 

S3 



RETURN 



As soon as return is typed, the serial data can be sent by the external 
transmitting device to the Serial Interface. As it is received, the incoming 
data will be stored in your APPLE’S memory from address 4000 through 
address 5FFF. 



Note: when the Serial Interface is instructed to receive a batch move, 
the cursor on the receiving APPLE'S TV screen disappears, and the Inter- 
face waits patiently until all the specified locations have been filled with 
received data. Then the cursor returns. 



BATCH MOVES FROM BASIC 

While it is easiest to use the Batch routines from the Monitor, it is also 
possible to do Batch Moves from BASIC. In the following discussion these 
definitions will hold: 

BAL = Beginning Address Low 

(the two rightmost digits of the 4-digit hexadecimal starting address 
for the move, converted to decimal) 

BAH = Beginning Address High 

(the two leftmost digits of the 4-digit hexadecimal starting address for 
the move, converted to decimal) 

EAL = Ending Address Low 

(the two rightmost digits of the 4-digit hexadecimal ending address for 
the move, converted to decimal) 

EAH = Ending Address High 

(the two leftmost digits of the 4-digit hexadecimal ending address for 
the move, converted to decimal) 
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Suppose you wish to send someone a picture from your APPLE'S high- 
resolution screen (page 1). The memory for this screen lies between 8K and 
1 6K, from hexadecimal address $2000 to hexadecimal address $4000. For 
the Beginning Address $2000: 

BAL = $00 (hex) = 0 (decimal) 

BAH =■ $20 (hex) = 32 (decimal) 

For the Ending Address $4000: 

EAL - $00 (hex) = 0 (decimal) 

EAH - $40 (hex) = 64 (decimal) 

1. Batch Output from BASIC 

The following BASIC program does the same task that the Monitor 
Batch Output command did. See the discussion of the Monitor Batch 
Output for more details. 

10 PR#1 : PRINT " " (initializes Interface) 

20 POKE 60, BAL : POKE 61 , BAH (sets starting address) 

30 POKE 62, EAL : POKE 63, EAH (sets ending address) 

40 CALL -14015 (jumps to Output Routine at $C941) 

50PR#0 (returns to normal TV output) 

60 END 



2. Batch Input from BASIC 

In the Batch Output program, above, change line 40 to 
40 CALL -14019 (jumps to Input Routine at $C93D) 

The resulting BASIC program does the same task that the Monitor 
Batch Input command did. See the Monitor Batch Input discussion for 
more details. Note that the IN#1 is not necessary for accepting input 
through the Serial Interface, because CALL -14019 deals directly with 
the Interface (not through the input and output “vectors” set by PR#and 
IN#). In fact the PR#1 in line 10 was necessary only to initialize the 
Interface; 

10 CALL -16128 
would have done as well. 
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VI APPENDIX: SERIAL INTERFACE TIMING 

TABLE OF BAUD RATE QUANTUM NUMBERS 

The following is a table that gives seventeen of the most commonly 
used baud rates, along with their quantum value (for POKEing) and percent 
error. Although only seventeen different baud rates are shown here, any 
integer from 0 through 255 may be POKE’d into the proper address 
(1 144+s), and each will give a different baud rate. 

Average APPLE II Frequency 1 .0204842 MHz 

Period .979926 microseconds 
Jitter +139.7 nanoseconds every 65th cycle 

Baud Rate Loop Quantum** 53 APPLE II Cycles (51.94 microseconds) 





Quantum No. 


Period 


Actual 




Baud Rate 


(Hex) 


(Dec) 


(microsec.) 


Baud Rate 


% Error 


75 


$ 00 


* * * ^ 


13296 


75.20 


+ .28 


90 


$ D6 


214 


11115 


89.96 


- .037 


110* 


$ B0 


176 


9141 


109.4 


- .548 


134.5* 


$ 90 


144 


7479 


133.7 


- .586 


150 


$ 80 


128 


6648 


150.4 


+ .28 


240 


$ 50 


80 


4155 


240.67 


+ .28 


300* 


$ 40 


64 


3324 


300.85 


+ .28 


450 


$ 2B 


43 


2234 


447.74 


- .51 


600 


$ 20 


32 


1662 


601.7 


+ .28 


900 


$ 15 


21 


1091 


916.8 


+ 1.86 


1200* 


$ 10 


16 


831 


1203.4 


+ .28 


1800 


$ 0B 


11 


571.3 


1750.2 


-2.78 


2400* 


$ 8 


8 


415.5 


2406.8 


+ .28 


3600 


$ 5 


5 


259.7 


3850.59 


+6.96 


4800* 


$ 4 


4 


207.7 


4813.6 


+ .28 


9600* 


$ 2 


2 


103.9 


9627.2 


+ .28 


19200* $ 1 

DIP switch selectable 


1 


51.9 


19254.4 


+ .28 



** Quantum = 

(.00005194) * Baud Rate 



***The quantum number zero is treated as 256 ($100). 
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22*0 

2250 

22*0 

227f) 

2280 I 

2290 ) 

2.! 00 MOV 10 
2310 



LDY N 10 
LDA COL.X 
SBC F'UOTH r X 
CMP MF8 
8CC SETCH 
ADC M27 



RECOVER CHAR AT CURSOR 

H0lm0NI8L index 

MNO ROOn LEFT IN THIS R.O.fl.) 



1 CHECK FOR COLUBN 
! JJIDTH UITHIN 8 CHARACTERS 
.' OF PRINTER WIDTH 
S BRANCH IF NOT 
JFORM 32-39 FOR BASIC LIST 
I FORMATTING... 



CIO* 1*0 III 0/ 
UH f *A 

lilt 12 m. 

cme no «v 

Cl HO VI) III 0*. 
Cl VO V() o* 
Civ;< av iia 

civ* no j* 

CIV* 1*1) III 0 7 



Cl AT 1*0 (*V 
CIAI OV tO 
CIPtI 10 .10 0% 
CIO I *5 '* 

c.i or. of. 2* 
cm t no io on 

0 I HA ( *. 2* 

Cl PC *0 

non ho oi 

El So aU ao 

CIC5 fo oj M 

ci i.7 » i iii on 
Lie A (10 
CILP *0 
Cl Cl vd PR 05 
c in .*0 Art rv 
cii>2 *o 

CIDJ *V 01) 

(1 05 00 I* 

do/ vo io on 

(IDA 05 7* 

Cl DC PI) 10 0/ 
Cl 01 *0 

Clf.O 7V *0 

c i f :» on o ,i 
C I h * 20 Ail t r. 
Cll 7 *0 
Cllll * A 
I II V AV HA 
CIFP PI) 0* 

CUD Pt) .<0 0* 
ciru io ov 
C I F 2 ID 30 or. 
c i f n eo o* 

C1F 7 A9 (JO 



2*10 I 

2*?0 Sf ROUT 1 
2*30 



2530 

25*0 

2550 DONE 
25AO 

25 70 
2500 I 
2590 I 
7*00 0UT1 
2610 

26 20 
2* ID 

m 
2*60 
2*/0 
2*00 
2 6 VI) 

2700 

2710 CURSOR 
27? 0 
2 7.11) 

27*0 
2 750 
2 7 60 

2 7 70 CTRL T S T 
2780 
2 791) 

2600 CTRL 
2010 CRI.F 
2820 
2631) 

28*0 
2850 
2860 
28 71) 

2800 
21)90 
2900 
2 V 1 () 

2970 

2930 OLAY 

2950 UCHK 

2960 

2970 

29R0 STOP 
2991) 

3000 

3010 

3020 

3030 

30*0 NX T CHR 
3050 



STATUS, X 
OUT 1 
M7F 

STATUS, X 
I l AOS , X 



PNF DONE 
STA COL.X 
BCC DONE 
L DA M f 8A 
PCS CTRL 
L DA FLAGS, X 
BMI NOVIO 



L DA F LAGS , X 
PPL CURSOR 
IDA CH 
CMP COL , X 

m sv?? ok 

PCS CURSOR 
ORA HtFO 
DND COL.X 
ADC CH 
STA CH 
LOA COL.X 
CMP CH 
FLA 

PCS CTRL TST 
PH A 

IDA N t AO 
BIT IORTS 
PEG CTRL 

PHP C ° L ' X 



EOR M $80 
PNE STOP 
STA COL.X 
STA CH 
LOA FLAGS, X 

AND M$*0 
PNE LF CHR 
JSR WAIT 



LDA M$0A 
PCS CRLF 
LOA PUOTH.X 
BEQ NXTCHR 
SBC COL.X 
8CS NXTCHR 



!rec55f1 e JhM^ eeed "°° e 

I CHECK FOR CARRAGE RETURN 

NODE 

JWacS N Jt 81 l? 5 UT * lW r?l6 

I CHECK VIDEO PIT 
I NO VIOEO EXIT 
I OUTPUT VIDEO 

CURS0R 

I BRANCH IF CH>COL 



f fl SP ! EY CH MOD (16) IF APSOFT 
I OR MOD ( B ) IF INTEGER P.ASIC 



(TAB CHECK 
I RECOVER CHARACTER 
I BRANCH IF NO TAB 

I GENE RATE SPACES 

fOON'T COUNT CTRL CHAR 
IN THE C°L COUNT 
J SAVE P-STATUS 

! CHAR TO SHIFT-REG 
IGO SHIFT IT OUT 
{RECOVER CHARACTER 
ICARRAGE RETURN CHECK 
I BRANCH IF NOT CR 
SRESET COLUMN COUNTERS 

I MUST CHECK FOR DELAY OPTION 



IGET FLAGS AGAIN 

S LOAD A LINE FEED 

{OUTPUT IT IF LINE-FEED MODE 

ICHFCK FOR COL-MAX 

* IF PUDTH“0 THEN NEVER MUX IN A CR. 

) BRANCH ON COL < PUOTH 
I MUX IN A CARRAGE RETURN 
I BRANCH ALWAYS 

JBRANCH ON TAB 
JFINISH OUTPUT 



ORG 1C 800 
OF I SERIAL2 



Ills ! ‘ r x?Tpn E? 

3 J fg j !» 2,3 SELECT 1 OF 8 BAUD RATES. 

31R0 5 A DELAY AFTER CR OPTION 

3 1911 I 7' 6 SELECT 1 OF * COLUMN WIDTHS 

3200 ! 7 LINE FEED AFY ER CARRAGE RETURN. 

3 2j.O I ON ENTRY X * i C N « A ■ t C N > Y MAY BF ANYTMTMR c u t t r u miict 

|220 j BE SET TO DESIRED CONDITIONS. ANYTHING * SWITCH MUST 

^ EXIT X = CN , REGS AtY ARE MODIFIED THF r A ft If Y dap ic 

3280 » ****»»****»***#«*»**##*,,« 

3290 ; 

3300 DEFAULT LDA DEV.Y I READ SWITCH 

3320 SKd »«7 ,SM ' E 5UIT <* STATUS 

3330 TAY IOFT (1-7 tm v 

||sg !iil Ja h 5d p £!!?f_ ou * ntu " 

3370 ASL A IRECOVER SWITCH STATUS 

3380 ASL A 

3400 PHA ^ {PREPARE FLAGS 

3J20 IK 3flg° ’ 0E,ER " INE UIDE ° 811 

I* " BE<0 8¥2 , , II 5 E c ?ri 5 fe OCK 
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TAY 

LDA WDTAP..Y 
STA PUOTH.X 
LDA H 1 2 
STA STPBITS.X 



LDA M $ 7 
STA STATUS, X 
CPX CSWH 
BNE NOTOIJT 
CMP CSWL 
BEO NOTOIJT 
STA CSWL 
CLC 

PCC GOODATA 
CPX KSUH 
PNF. NOT INF' 
LDA H>SER I N 
STA KSUL 



{DETERMINE WHICH COLUMN WIDTH 

I TRANSFER 0-3 TO Y 
: £§, T .,- W1DTH erom TABLE 
ISAVE COLUMN UIDTH 
»SET THE NUMBER OF STPBITS 

lONO THE DATA BITS 
HAST. THE PARITY STATUS 



J < INDICATE OUTPUT) 

I SET KEY IN VECTOR. 



I ( INDICATE INPUT) 



ON ENTRY X = tCN . 



SEI 

LDA STATUS. X 
AND M $3 
LSR A 
ROR PARITY 
PHA 

LDA NBITS.X 
STA NCOUNT 
LDY NO 
SEC 

PCS GFTPIT 
LOY NO 
DEC NCOUNT 
BEO CHKPAR 



! NO HARD INTERRUPTIONS. PLEASE 
) PREPARE FOR PARITY/STOP BIT OPTIONS 
5 IF BIT ONE IS ZERO THEN PARITY, IF BIT 7ER0 IS 
l ZERO THEN EVEN PARITY U ‘ b 

.'INITIALIZE PARITY 
* I F A*0 THEN PARITY IS EXPECTED 

UNITIALIZE BIT COUNT 



l ARE ALL THE PITS IN YE T 7 



PCC SAVPIT • 
BPL GOTSTRT 
L DA KBD 
BPL GETBir 
STA BYTE.X 
BIT KBDSTRB 



I BRANCH IF DATA 
> BRANCH IF START BIT 
! MAYBE THE KEYBOARD WANTS ATTENTION 
INO, WAIT FOR THE START BIT 

) CL EAR KEYBOARD 

IYES. BETTER FIX THF STACK BEFORE RETURN 
l THE KEYBOARD INTERRUPTED THE INPUT' 



IMUST CREATE A DELAY SUCH THAT DATA IS TAi'FN 
I AT THF CENTFR OF THE S I GNAL . ( PR ANCH A! WAYS) 
I DONE WAITING AROUND 7 

j Y js. it 0ATA 1IME 



™ E .9 ATA 1NT ° CARRY 
(THEN PUT IT AWAY. 



•UPDATE THE PARITY 

IGET THE PAUD DELAY NUMBER 



LDY M 1 9 
DEY 

PNE WAIT 53 
BEQ UAIT1 



lOEl.AY"53i»(BRATE-l ) CYCLES 



Branch IF Parity* th,u 15 THE 0UESn0N 
IGET THE PARITY BIT 

l DOES THE ONE SENT MATCH THE CALC1IIATFD? 
INOT IF THE MINUS FLAG IS ON L " LLULrtTED ' 

| n,l RllURNING HE 5n!N '' L ,S HIGH REFORE 

I HOW MANY BITS TO BAKE A WHOLE BYTE 7 
iSKMVra* B1T C0UNT ’ N REOISTER-Y 

I BRANCH ALWAYS 



* THE FOLLOWING ARE VARIOUS EXIT ROUTINES. 



{RESTORE ALL REGISTERS 
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C8CF 09 

cnno 

OHO? 09 
CHIU 911 

OH OH 3 8 
CH09 4C 
CHOC 

cniSr U 

CHE 1 09 
C H 0 J 09 
CHI i, DO 
CHf ; Bt 
CHI 9 C 9 i 
CHOB 90 
CHID ?*, 
CHLF 09 
CHF J 90 
CI1F J A4 
CHI 5 00 

chi ; i n 

( III 9 ?9 
CHI H Al 

m ?v 

CBM HO 
cvni zu 

C90? BO 
C9IU 09 | 
C9 06 30 I 
C90H DO I 
C90A A 9 , 
CfOC 10 
( 901 DO ( 
C9| I AV r 
C9I3 31) . 
C9IA 91) 
C9I9 III 
C9 I A HD f 
C9K) 09 | 
C9|l VD I 
09?? AC • 
C923 

C9?3 (U ; 
C9?5 AH 
L' 9 ? A AH 
C92 7 AH 
C9?H AA 
C92V AH 
C9?A PI) r 
C9?C AO / 
C9?» ?n 
C 930 AO 

c?|l 



A/ZO FOR 

4 730 mxtout pi F- 

i*740 JMP 

4 75(3 I 

<740 INF INSH SIS 

<'70 LUO 

<180 ORA 

4 790 r pip 

4 8 00 p.NE 

4010 LOA 

4 8 20 NOT PICK CMP 

4830 BCC 

4040 AND 

4050 CMP 

4860 BCC 

4870 LDY 



4090 
4900 
4910 
4 9?0 

4930 IVERSE 

4940 FXIT1 

4950 

4960 

49 70 

4900 

4990 

5000 

5010 

5020 

5030 UPPER 
504 0 



STA (PASL).Y 
LOA BYTE.X 
ORA M *80 
CMP MPICK 
BNE NOT PICK 
LOA (BASL).Y 
CMP M *E0 
BCC EXIT1 
AND CASE 
CMP M *E0 
BCC EXIT1 
LDY CSWH 
CF'Y «*FD 
BED TVF.RSE 
AND H»7F 
I DY IORTS 
0R6 *-2 

AND 0* IF 
STA 0LDBY7E 
PLP 

PCS NOTESC 
CMP H*CC 
BMI UPPER 
PNE NOTESC 
l. DA H * 20 
ORA FLAGS , X 
PNE ST OR'FLGS 
LDA M * OF 
AND FLAGSrX 



I82S §;?^ GS ?;g EE4G ^s 



5070 

5080 

3090 

5100 

5110 

5120 EXIT? 

5130 

3140 

3 1 50 

5160 

5170 

5100 

3190 

5200 RE TOUT 

5158 . 

5240 l 

3250 » BAUD 
5260 I 
52 70 BTAP. 



LDA STATUS. X 

ORA 0*80 

STA STATUS, X 

10Y JORTS 

ORO * - 2 

STY CH 

PLA 

TAY 

PLA 

TAX 

PLA 

PCS RF TOUT 
IDA OLDBYTE 



irir L S£lT F ^^ ING CURSOR 
IGET MOST RECENT INPUT 

! SCREEN PICK (CONTROL-U)? 

IGET SCREEN CHARACTER 

IDO NOTHING TO UPPER AN NON-ALFA 

;Sf?^°ri5^ 0 cil^ E fF , ^k^ E N o OT ENRGEE0 

I OTHIRWISE JUST STRIP PIT 7 
I ( DUMMY LDY ABSOLUTE) 

!"$}<! IT INVERSE VIDEO 

: ?F U rSRRv r, E F CORRECT BUFFER 

• IF CARRY CLR , DO "ESC" FUNCTION 

IIS IT AN ASCII "L" 

• CAPSLOCK COMMAND IF >L 

TENABLE LOWER CASE 

.'BRANCH ALWAYS TAKEN 
(DISABLE LOWER CASE 

(INDICATE INPUT RETURN 
(INDICATE AFTER INPUT (TO OUTPUT) 

((ANOTHER DUMMY) 

(RESTORE CURSOR HORIZONTAL 

(RESTORE REGISTERS 
) EXCEPT REO. A IF INPUT RETURN 
(RETURN NEW INPUT 
(RETURN TO CALLER 



10 BAUD 
134.5 BAIJD 
300 BAUD 



DFP. *2 
DFB *1 

WIDTH TABLE * 



COLUMNS 

COLUMNS 



5370 WDTAB DFB *29 

3380 op o $9 COLUMNS 

5390 DPB }5S 72 COLUMNS 

5400 dfp, 2q 9 j 80 COLUMNS 

JJJJ t Fa8e 84 1 132 COLUMNS 

5430 I 

iiiKW 

53TM I ^CGISTERS ARE UNDEFINED. 

5540 l * * * * * * * * * * * > « 0 4 , #.0. 4 , 

533U I 

5370 IMFUT IORTS I SE T VF LAG TO INDICATE INPUT 

5580 ORG » - i 

0400 ° UTEUT fox nsL0T !G CT READY FOR BATCH NODE 

813 fig | ,4,us ->' 

MAO LSR A 'DETERMINE CHECKSUfl 

5650 BATCH PHP 

LDY « 0 

5480 STY ciSSsT 'INITIALIZE CHECKSUN AND COUNT 

5690 BVS MOVIN 

3710 " <I '' 0UT ^TA B?!e!x Y ,GET ™ E 0,1,4 ,0 eE OUTRUT 

5730 !? A S? iUF ' 04,E CHECKSUM 

5750 "lie ,D0 OUTPUT IT 

5740 PCS ,,NCRE " ENT fOINIEHS 

1 7 80 ICf SSvOUT 1UPD4TE 8YTE C0UNT 

5600 I.CS PATCH !D ° CHECKSU " IT CARRY CLR 

111 0 feW BYTE? X !°iLOCK E OUTluT SU " FI>R ™ E L4ST 

5840 BCC BAICH 'PrJS8m L^A^ 0 * 50 " 

5850 FINISH PLA BRANCH ALUAYS 

O g<0 PCS RE TBATCH 

5870 JSR CROUT 



|1T IORTS 
BCC * 

ORG **-l 
CLV 

IDX MSLOT 



STY CKSUM 
STY COUNT 
BVS MOVIN 
LOA (AIL) , Y 
STA BYTE.X 
E OR CKSUM 
STA CKSUM 
JSR SHOUT 
JSR NXTA1 
PCS FINISH 
INC COUNT 
BNE MOVOUT 
PLP 

BCS PATCH 
LDA CKSUM 
STA BYTE.X 
JSR SHOUT 
BCC BATCH 



(SET VF LAG TO INDICATE INPUT 
(GET READY FOR BATCH MOVE 



(DETERMINE CHECKSUM 

UNITIALIZE CHECKSUM AND COUNT 

(GET THE DATA TO BE OUTPUT 
(UPDATE CHECKSUM 

(GO OUTPUT IT 
(INCREMENT POINTERS 

(UPDATE BYTE COUNT 

(DO CHECKSUM IF CARRY CLR 

! 0 ilOCK E OUlluT SUn F ° R ™ E L4ST 

ira Jl h Ia^ ecksu " 



5900 RETBATCH RTS 



(GO PRINT "ERR" 
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